INSTALLATION OF AEMAIL (March 31, 2001) The AEMail Install Script uses the Installer program first provided by Commodore and later revised by Amiga Technologies. You should use the Install_AEMail script to install AEMail. It is not recommended that you attempt to install AEMail by hand since some actions are necessary through the install script. This is especially true if you are attempting to install a registered version of AEMail! Installer and Installer project icon (c) Copyright 1995-96 Escom AG. All Rights Reserved. Reproduced and distributed under license from Escom AG. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. Starting with Version 2.00 of AEMail, the Installation script was completely re-written from previous versions. You can now define multiple users with the install script and use the install script to add or update users as well as delete users (Version 2.30 and above). The script was further modified for Version 2.20 to place additional edits when naming configuration files and your mail directory. The script also installs the ClassAct classes required by AEMail if you are installing with an OS prior to 3.5. If you are installing to OS 3.5, it is not necessary to install the ClassAct classes since they are built into the OS. In OS versions prior to 3.5 you will be asked if you want to install ClassAct. It is not necessary to do this if you are already have ClassAct installed on your system (either by a previous AEMail install or with another program using ClassAct). Other changes to the Version 2.20 installation script include: Changing RAM: to T: for saving temporary files. On most Amigas, T: is in RAM: However, in some low memory situations, a user may assign T: to a hard drive. By changing RAM: to T:, users with low memory conditions can still install AEMail. If you have previously installed a version of AEMail 2.00 or above, you can bypass the "Configuring Users" portion of the script as long as you do not want to add to your users or update a user. Further changes to the Version 2.30 installation script include: The ability to delete users. The installation script now asks what type of installation you are performing: a demo version, a previously registered version, or a new registered version. Please read these instructions before attempting to install AEMail. If you have the diskette version of AEMail, you will find that it is now a two disk set. Place Disk_1 in your drive to start the installation. At the appropriate time you will be asked to insert "AEMail_V2.30-Disk_2". If you are installing from a version obtained over the Internet or from the AEMail CD-ROM, you will not get this message. To install AEMail simply double click on the "Install_AEMail icon". The install script provides two user levels that the user can choose: Intermediate (control of configuration parameters only) Expert (control of configuration and where files are placed) See below for actions that are different between the two user levels. The first thing that the Install script will ask is what type of installation you are performing: A Demo Version A Previously Registered Version A New Registered Version If you are installing a new registered version you will need a key code which was provided when you purchased AEMail. You will not be able to continue with the installation if you can not provide the correct key code. In this event you should re-install using the Demo Version and contact the author at jzachar@calweb.com for further instructions. Likewise, if you are installing a previously registered version, the installion script will attempt to locate your registration information in a file called .registration in you main AEMail program directory. If your previous installed version was prior to 2.00, it will look for the registration file in AEMail:.registration. If it can't be found you will be instructed to install at the Demo Version level and to contact jzachar@calweb.com for further instructions. Before doing that, however, execute your newly installed AEMail and see if it is a registered version. The Install script then makes an attempt to determine which TCP/IP stack that you have installed. This controls which defaults will be taken. The way the install scripts knows which TCP/IP stacks are present is as follows (you must have installed the particular stack before installing AEMail): AmiTCP: This is controlled by the presence of the AmiTCP: assign statement and the presence of the AmiTCP:bin drawer. The AmiTCP: assignment and the AmiTCP:bin drawer were automatically created when you installed AmiTCP. Miami: This is controlled by the presence of the Miami: assign statement. When you installed Miami you should have let the install create the Miami: assign. This was only available under later versions of Maimi. While the Miami: assign is not an absolute requirement if you are using Miami, it is required if you intend to use the supplied "startnet.miami" script without modification. This script locates Miami with Miami:Miami which depends on the Miami assign. If the Miami assign is not present you would have to modify the script to use the full path name of where Miami is located. TermiteTCP: This is controlled by the presence of the TermiteTCP.prefs envronomental variable. Also, if you want to pick up some of the other TermiteTCP variables, such as email address, you must have run TermiteTCP prior to installing AEMail (TermiteTCP does not have to be online, however). The install script will ask you to verify which TCP/IP stack you are using. A fourth alternative "Other" is provided if you have another TCP/IP stack or you have not as yet installed your chosen stack software. If you have multiple stacks installed, the initial stack selection is made in this priority: Miami AmiTCP Termite-TCP You can, of course, change this with the requester. If you select the Intermediate user level, the following actions will be taken: If you have previously installed AEMail with a version 1.10 or greater, the install script will determine where AEMail was previously installed from the ENV:AEMail_Dir environmental variable. If you have not previously installed AEMail or you are updating from an AEMail version prior to 1.10, the AEMail executable file will be placed in AmiTCP:bin if the AmiTCP stack was selected or, if one of the other stacks was selected, on the largest partition on your hard drive. Note: No special directory will be created if AmiTCP is selected, otherwise a directory called "AEMail" will be created for containing the AEMail executable. When the installation script terminates it will tell you where it placed the AEMail executable. The reason that AEMail is placed in the AmiTCP:bin drawer if the AmiTCP: assignment is present and you selected AmiTCP as your TCP/IP stack, is that the "startnet" and "stopnet" scripts for AmiTCP should be in the same directory that contains AEMail if they are to work without modification. The AmiTCP installation places these scripts in the AmiTCP:bin drawer. For OS Versions prior to 3.5, the ClassAct classes will be normally installed to your SYS:Classes drawer. You will be asked if you want the 020 optimized version of the classes. If you are running on an 020 or greater processor, reply "yes". With OS 3.5, the ClassAct classes will have been installed when the OS was installed. The documentation files that you want copied will be copied to a drawer called "documentation" in the drawer which contains the AEMail executable. A special ARexx documentation file (which is also part of the AEMail.doc and AEMail.guide files), is placed in a drawer called "ARexx" in the drawer which contains the AEMail executable. This drawer will also contain some sample ARexx scripts. If you want the AEMail.readme file, it will be copied to the directory containing your AEMail executable. The ARexx scripts StartNet.Miami and StopNet.Miami will be copied to the directory containing your AEMail executable providing they are not already there. This prevents copying over scripts that may have been previously modified. A handy registration form called "registration.form" will be available in your main AEMail directory. It has an icon which, if you double click on it, will use the "PrintFiles" program in your SYS:Tools directory to print out the registration form. You will be asked how many users you want configured. See the section below on Configuring Users to see what happens here. If you are updating a user, you can change their mail directory. However, if you are creating a new mail directory rather than using an existing one, you will start out with a blank address book and empty standard folders. If you are running under AmigaDos 3.0 or greater, the supplied mailcap file will be copied to the mail directory for each user unless a mailcap file already exists in that user's mail directory. No mailcap file will be copied if one already exists in the user's mail directory or if you are using AmigaDos 2.1. An AEMAIL2: assign statement pointing to the drawer containing your AEMail executable will automatically be placed in your S:User-Startup file. An "ASSIGN C: SYS:REXXC ADD" will also be added to your s:User-Startup file to provide a path to your AREXX commands. The following additional capabilities are provided when you install at the Expert level: You will be able to choose which directory AEMail will be installed in. If you are installing AEMail for first time, this may be desireable rather than installing in the largest partition on your hard drive. The default directory that is selected will be the one that would have been selected under the Intermediate level. You will be able to choose which directory you wish to install your Documentation files in. WARNING: for the Help function to properly work, the AEMail.guide file must be in the "documentation" drawer within the drawer which contains the AEMail executable. You can change the location of the .guide file by using the "HELP=" Tool Type. This must be done manually. The Install script WILL NOT set this tool type. You will be able to choose which directory you wish to install your ARexx files in. You might want to select the Rexx: directory for this so that the supplied ARexx scripts become immediately available. If you want a mailcap file other than the one provided, you can select where you want this file copied from. If you want to use the alternate mailcap provided in the ARexx drawer for displaying HTML documents with your browser, you could specify the AEMail ARexx drawer for the source of the mailcap. As noted above, the default drawer in which your documentation is placed is a drawer called "Documentation" in the drawer containing your AEMail executable. This is different from versions prior to 1.50 where the documentation files were placed in the same drawer as the AEMail executable. Documentation files located in the drawer containing your AEMail executable WILL BE deleted by the installation script. If you want these retained you will have to re-name or save them yourself. Towards the beginning of the script, after you have identified your TCP/IP stack, the script will determine if you have already installed the current version of AEMail. If you have, you will be asked if you want to do a Full Install or want to add, delete and/or update users. If you just want to add, delete or update users, you will go immediately to the "Configuring Users" section described below. Configuring Users ----------------- You can set up multiple users of AEMail from the Install Script. Each user will be provided a Project Icon named as the user wishes. This project icon will point to the AEMail executable and will be created with certain required Tool Types as "configuration" items. The Project icons will be created with the Install_AEMail script. If you have previously installed a version of AEMail 2.00 or above, you have already established your users. In this situation all of the users that have been previously defined will be displayed and you will be asked if you want to "Add/Delete/Update Users" or "Accept Current Users". If you reply with "Accept Current Users", the user configuration section will be bypassed. If you have not installed AEMail previously or your previously installed version is prior to 2.00, you will be asked how many users with different email addresses you wish to configure AEMail for. You must have at least one user. Certain questions will then be asked for each user so that appropriate Project icons can be created with the appropriate Tool Types. If you already have established users and replied "Add/Delete/Update Users" you will first be asked if you want to delete any users. If you do, your existing users will be displayed and you can select the one you want to delete. The script will determine the Configuration file used by the user you want deleted. It will display a requester asking if you want to delete this configuration file. Unless you want to use this configuration file again, you will want to delete it. The script will then determine the Mail directory for the user you want deleted. Again it will ask if you want this mail directory deleted. If the mail directory is being used by another user you should not delete it. After that user is deleted you will be asked if you want to delete another user. If you don't, you will then be asked how many users you want to add or update. You can reply 0 to this message which will then bypass establishing or changing any users. As each user is processed you will get a message asking you to select the name of the icon you want your user to have. Since you can both create a new user or update an existing user, you will be present with a list of choices that looks like this: Create new icon name-of-previously-defined-user-1 name-of-previously-defined-user-2 ........... name-of-previously-defined-user-n Only the names of previously defined users will appear in this list. If you select any of the users or the "Create new icon" entry you will get a message that asks you to enter (or confirm) the name of the user (icon name) that you want the user to have. When you select "Create new icon" a default name will be used that will be one of the following: AEMail_User_1 AEMail_User_2 AEMail_User_3 ........... AEMail_User_n You can change the name or use the one provided. You will then be told if the icon already exists or not and asked to confirm that this is the correct name. If you are editing a previously created icon, that icon, of course will exist. You will be given an opportunity to re-enter the name if you decide it is wrong. If you are updating from a previous version of AEMail (before 2.00), you will already have a "Tool" icon for AEMail. If you select "AEMail" as the name, the "tool" icon will be turned into a Project icon for your primary user and all existing Tool Types will be obtained as default values. If you choose to change the name of the icon, the "AEMail" tool icon will remain. WARNING: Do not try to DELETE any icon called "AEMail" (tool or project) AFTER you have installed AEMail using the workbench "Icons/Delete..." menu item. This will delete the AEMail executable as well. If you don't want the "AEMail" icon it is best to delete it BEFORE installing AEMail or use the delete function described above to delete the icon. The required Tool Types that will be created for each user's Project icon are: CONFIG= MAIL_DIR= PASSPROTECT=YES The CONFIG= Tool Type points to the configuration file for that user. This configuration file must be unique for each user. Under both install options (Intermediate and Expert), a file requester will appear for you to select the configuration file name. If you are not updating an existing user, this configuration file will not exist so you can enter whatever you like (providing a file with the same name is not present). You can select any drawer, but either the drawer containing the AEMail executable or the s: directory are recommended. If you start AEMail from the shell without any arguments, you will need to name your primary user's configuration file aemail.cnfg in the s: directory. If you are doing a full install and you have a s:aemail.cnfg file, this file will automatically be selected as your default configuration file for your first user provided no configuration file was previous specified in the "AEMail" Tool Types. If you install at the "Expert" level, you will be able to copy and/or rename this file to another location. The MAIL_DIR= Tool Type is used to specify where your mail directory is located. In versions of AEMail prior to 2.00, the AEMail: assign was used to specify the mail directory location and the Tool Type was only used if the mail directory differed from that. This is no longer the case. With version 2.00 and above, the AEMail: ASSIGN statement is no longer used, the mail directory will always be specified by the MAIL_DIR= Tool Type. After installing a user you can change their mail directory by either changing this Tool Type or by running the Installation script again to update this user. If you are updating from a version of AEMail prior to 2.00, the AEMail ASSIGN will be used to specify the default MAIL_DIR unless a MAIL_DIR= Tool Type was previously specified in an updated icon. For new users, you will be given an opportunity to accept the default as the mail directory or specify a new mail directory location for each user. The MAIL_DIR does not have to be unique to each user. Two or more users can share the same mail directory. If the mail directory you specify is not present, it will be created. The PASSPROTECT=YES Tool Type is used to password protect the mail directory for a particular user (only available for registered users). You will be told whether the mail file is currently password protected or not and then be asked if you want to password protect the mail directory for this particular user. If the file was previously password protected, you can turn that feature off by replying 'No'. To continue password protection you will have to reply 'yes'. The password that is used to password protect the directory is the same one that is used to access the POP server by that particular user. Previously an INTERLACE=YES Tool Type was used to specify the screen mode that AEMail would initially open on. This Tool Type is now obsolete. AEMail will now initially open on whatever screen mode is set for your Workbench screen. After initially loading AEMail, you can change the screen mode through the Configuration Edit screen, General page. You will also be able to provide additional configuration data for each user that will be stored in the Tool Types parameters of the AEMail Project icon for that user. If the user has an existing Configuration file, you will be asked if you want to re-configure this user's data. If you do, the existing configuration file will be renamed with ".old" appended to it. If the user does not have an existing configuration file, you will be asked if you want to configure now or wait until AEMail is first loaded. Since you can change the configuration data from AEMail, the Configuration file always takes precedence over the Tool Types. The only exceptions to this are the name of the configuration file (CONFIG=) and the name of the mail directory (MAIL_DIR=). That is why any existing configuration file is renamed to avoid resetting the configuration data when AEMail is first loaded. Certain configuration parameters must be provided before AEMail will run. These configuration parameters are provided either by Tool Types in the AEMail icon or through a special Configuration Setup Window when you first run AEMail and saved in the user's configuration file. If these parameters are not provided by Tool Types (through the installation script) or by an existing configuration file, the Configuration Setup Window will be displayed upon the initial startup of AEMail. You can not proceed beyond this configuration setup until certain required configuration parameters are provided. The absolute minimum configuration parameters that must be provided are: POP3 UserID Password Your email Address POP Server Name SMTP Server Name Domain Name Edit Call For a full discussion on configuring AEMail, refer to the AEMail documentation or guide files. If you decide to configure using Tool Types, the installation script will try to automatically configure certain items to default values. These include the switch for deleting mail from your POP Server once it has been transferred to your Amiga and the switch for stripping duplicate messages. The edit call will default to c:ed and will open the editor on the Workbench. Also, if you have your TCP/IP stack loaded (not necessarily on-line), it will obtain certain default items from environmental variables stored by the stack software. The installation script will allow you to provide additional configuration parameters as Tool Types in your AEMail icon or to change the default ones. A POP Server name and a SMTP Server name must be provided. However, if they are missing AND, if the Domain Name has been specified, default values will also be assigned to these items. These default values will prepend 'POP.' to the domain name for the POP server and 'SMTP.' to the domain name for the SMTP Server as defaults. Please note: these may NOT be correct for your POP and SMTP servers. If they are not, you will have to change these items with the installation script. Some Internet Service Providers use mail. prepended to the domain server for both the POP and SMTP servers. If you have a problem understanding what should be entered with the install, use the HELP function of the Install script. Here is some of the help information from the script: "The domain name is usually the part of your e-mail address that follows" "the '@' sign. If something else is required by your Internet Provider," "provide it here." "As an example, my email address is:" "jzachar@calweb.com" "The domain name for my Internet provider is therefor 'calweb.com'." "POP Server. POP stands for 'Post Office Protocol' and your " "POP Server is the name assigned to the host computer that holds " "your Internet mail. Normally this would be 'pop.' or 'mail.' " "prepended to your Domain name." "Consult your Internet provider if the POP Server is called " "something other than the above." "SMTP Server. SMTP stands for 'Simple Mail Transfer Protocol' and " "your SMTP server is the name assigned to the host computer that " "sends your Internet mail. Normally this would be 'smtp.' or 'mail.' " "prepended to your Domain name" "Consult your Internet provider if the SMTP Server is called " "something other than the above." If you have installed and ran your TCP/IP stack before you installed AEMail, the only configuration parameter you may have to provide is your password. If you are using TermiteTCP, the POP3 UserID and the SMTP Domain Name are extracted from the email address that you gave TermiteTCP. Other stacks provide environmental variables to store this information. If these are not the correct values you will have to change them in either with the Installation script or through the Identity page of the Configuration Setup Window. One of the things that is needed to run AEMail is an editor. By default AEMail will use the AmigaDOS editor, ed, which comes with all Amigas. However, you can change this through the install to any editor that you want provided that you have specified that you want to configure AEMail when you do the install. Other Considerations -------------------- If you are using Miami as your TCP/IP software, special startnet.miami and stopnet.miami scripts have been provided with the install of AEMail. If you select Miami as your TCP/IP stack and the Miami assign is present, the install script assumes the Miami startnet and stopnet scripts should be used. If you are using AmiTCP, that software provides its own StartNet and StopNet scripts. They are usually in your AmiTCP:bin directory. It is recommended that you place AEMail in the same directory that contains these AmiTCP StartNet and StopNet scripts, although this is not an absolute requirement. If AEMail is placed in a different directory, you might have to modify these scripts to work properly. If the directory containing your StartNet or StopNet scripts is NOT the AmiTCP:bin directory or the scripts have names different from "startnet" or "stopnet", you will have to change the default values for the STARTNET and STOPNET tool types. You can do that with the installation script. If you are using TermiteTCP, there are no Start Net or Stop Net scripts. SPECIAL NOTE FOR MIAMI USERS: In the TCP/IP Settings page on Miami, the "Down when Offline" item should be checked and the settings SAVED. If this item is not checked, it will take AEMail 80 seconds to determine that Miami is offline if Miami is loaded but not online. WARNING: If you are updating and you change the mail directory for a specific user, you will lose all previous folder configuration data. You might also lose your registration information if you are a registered user. In versions prior to 2.00, the registration information was stored in your mail directory. Version 2.00 and later stores it in the AEMail program directory. The installation script will attempt to copy this information from the mail directory to the program directory. If the installation script can not find your old mail directory (usually by the AEMail: assign statement, you will need to copy this data yourself from your old mail directory to the new mail directory. The mail directory can start out empty. The AEMail program will generate any necessary configuration and support files required. The mail directory directory can be anywhere on any one of your hard drive partitions (or on a floppy or other read/writable media); it does not have to be in any specific directory; but it must be mounted when you execute AEMail. As stated above, you will need a "mailcap" file if you want to display MIME mail attachments. A sample mailcap file is provided on the AEMail program disk which uses MultiView to display audio, images, and video content types provided that you have the appropriate datatypes loaded into your system. This, of course, requires AmigaDos 3.0 or higher. If you are using AmigaDos 2.1, the mailcap file needs to be modified to reflect the display programs that you want. The installation script at the Expert level will help you do this or you can do this with the "Viewer" page of the Configuration Setup Window. If you are running under AmigaDos 3.0 or higher, the installation script will automatically move the supplied mailcap file to the mail directory for each user unless a mailcap file already exists there or unless you specified a different location for a pre-existing mailcap file (Expert level only). The mailcap file specifications are given in AEMail documentation and guide files. A special mailcap file is provided in the "ARexx" drawer to allow you to display HTML attachments with your browser. If you wish to use this feature you will have to copy the mailcap file in the ARexx drawer to your mail directory. This can be done with the installation script at the Expert level. Read the html.readme file in the ARexx drawer for details of this special mailcap file. The mailcap file can also be created or edited online with AEMail through the "Viewer" page of the Configuration Setup Window. AEMail gets the current time zone from either the locale.prefs file that is part of AmigaDos or the tz envronmental variable. See "Handling of Time Zones" below for further information on this. When the installation script terminates it will store the directory in which it placed AEMail in the Environmental variable "AEMail_dir". It also creates an assign statement in your User Startup for the AEMail program directory called AEMail2:. Starting with version 2.00 it will also store the version number of the current AEMail in the environmental variable "AEMail_Ver". This facilitates updating to future releases of AEMail. The version 1.30 and later installation scripts, at all installation levels, will look for the AEMail_dir Environmental variable to try to determine where to place AEMail. HANDLING OF TIME ZONES IN AEMAIL -------------------------------- AEMail will handle time zones in both full hour and half hour increments. AEMail uses either the "tz" environmental variable, a special "aem_tz" environomental variable, or the "locale.prefs" file that is part of AmigaDos to determine your local time zone. The "locale.prefs" file will only allow for full hour time zone offsets. You can use the "tz" environmental variable for half hour time zones, but, if this variable is used by other programs in your system it is suggested that you use the "aem_tz" variable instead. To set the time zone in the "locale.prefs" file, execute the Locale program under your Prefs directory by double clicking on the Locale icon. At the bottom right of the Locale Preferences window you will see a world map with a white line through it that indicates the time zone that you are in. To change this, click on the country you are in. The white line will move to that position and the Time Zone heading at the top of the map will reflect the time zone offset for your part of the world. Then click on the [Save] gadget at the bottom of the window. Currently AEMail first looks for the environmental variables "aem_tz" or "tz". The format for "tz" is dictated by SAS_C and should be aaabbbccc where aaa is the abbreviation for local standard time, bbb is the offset in hours from GMT (-11 to 12) which is SUBTRACTED from GMT to get the local standard time. ccc is the abbreviation for local daylight savings time or "summer time" (in the United Kingdom or Europe). If the time zone has daylight savings time this should be present even if daylight savings time is not currently in effect (contrary to the specification for "Tz" for the SAS-C compiler). AEMail automatically determines when DST or "Summer Time" is in effect. AEMail also recognizes an alternate form of "tz" where aaa and ccc can be abreviations longer than 3 characters. This is desireable in some European countries. AEMail will also recognize time zones in increments of one half hour. To specify an half hour time zone, specify it as + or - hhmm. As an example: +230 would specify a time zone in which 2 and a half hours are SUBTRACTED from GMT. You can enter the above with the "tz" environmental variable, but since this variable might be used with other programs in it's strict sense, an alternate environmental variable has been provided called "aem_tz". If "aem_tz" is present it will take precedence over "tz". If the "tz" or "aem_tz" environmental variables are not present, the system then attempts to get the time zone offset from the "locale.prefs" file. Only the time zone offset is present in this file. The abbreviations for local standard time and daylight savings time are obtained from a table that is by no means complete. Only the time zone abbreviations for the United States, Canada, and the United Kingdom are contained in this table, so one of the environmental variables is preferred. if neither the "tz" nor "aem_tz" environmental variables nor the "locale.prefs" file are present, the system defaults to CST with an offset of 6. NOTE: the standard header in an email message has the time zone offset sign reversed from that of the "locale.prefs" and the environmental variables. AEMail automatically makes this reversal, so the offset should be set to positive for US time zones and negative for European time zones. They will appear as negative (for US) and positive (for Europe) in the Date: header. You can set the "tz" or the "aem_tz" environmental variables by using the SETENV AmigaDos Command. This must be done from the shell. The syntax to use is as follows: SETENV tz aaabbbccc (for tz) and SETENV aem_tz aaaaaaaaabbbbbccccccccc (for aem_tz) aaa, your local time zone abbreviation must always be present. If you don't know your abbreviation (or don't want it in the header), use "xxx". If AEMail sees xxx it will assume that no abbreviation is present and it will be left off the Date: header bbb is the time offset in hours from GMT. Plus indicates that you are west of GMT and minus indicates that you are east of GMT. Acceptable values are -12 to 24. If you want to specify a half our time zone it can be entered as hhmm. If AEMail sees a value of 30 or above it assumes that a half hour increment is being used. In this case -1200 to 2400 are acceptable. If your time zone observes daylight savings time, ccc is the abbreviation to use for daylight savings time. If ccc is not present, no adjustment will be made during the times of the year that daylight savings time is observed. The result of the SETENV command is only in effect while your computer is on. If you want to make the "tz"or "aem_tz" environmental variables always present enter the one of the following AmigaDOS command after the SETENV command: COPY ENV:tz ENVARC:tz (or) COPY ENV:aem_tz ENVARC:aem_tz Using the "tz" or "aem_tz" environmental variables gives you more control over which abbreviations will be used for your time zone. However, the locale.prefs file may be more useful for those that prefer the "point and click" method of doing things. To set the correct time zone for locale.prefs, enter the Locale editor in your Prefs drawer. You will see a time zone map with which you can move the white strip indicating the time zone on the map. Click either to the left or right of the strip to move the strip. The correct time zone offset for standard time will be shown at the top of the map. Since the locale.prefs does not have any abbreviations, AEMail makes certain assumptions as to what the abbreviation should be. These assumptions are as follows: Time Zone Name Standard DST -----------Time Zone----------- Time (in "locale") (in email Date:) Greenwich Mean Time GMT* BST 0 +0000 Atlantic Time AST ADT 4 -0400 Eastern Time (US) EST EDT 5 -0500 Central Time (US) CST CDT 6 -0600 Mountain Time (US) MST MDT 7 -0700 Pacific Time (US) PST PDT 8 -0800 Yukon Time YST YDT 9 -0900 Hawaiian Time HST --- 10 -1000 International Date Line IDL --- 12 -1200 --- indicates this time zone does not observe DST *Note: GMT (Greenwich Mean Time) is also known as UTC or Universal Time Coordinated. If you want to use a different abbreviation or control whether DST is used or not, you should use the "tz" or "aem_tz" environmental variable. DST in the United States and Canada begins on the first Sunday in April. "Summer Time" in the United Kingdom and Europe begins on the last Sunday in March. Both DST and "Summer Time" end on the last Sunday in October.